home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / who503n.zip / WHOCALL.DOC < prev    next >
Text File  |  1992-12-31  |  10KB  |  238 lines
  1. WhoCalled? PRO! Version 5.00
  2.  
  3. 30 December 1992
  4.  
  5. PCBoard is owned by Clark Development Inc.
  6. WhoCalledPRO is owned by Bill Fink - User Friendly Systems And NCCBBS.
  7.  
  8. * * * New In Version 5.03N - WhoCalled Professional Is "N"etwork Smart! * * *
  9.  
  10. If you use a previous version of whocalled, you'll want to start
  11. version 5 from SCRATCH. (This INLCUDEs Owners Of Version 4.0)
  12.  
  13. "WhoCalledPRO!" Is "WhoCalled?" TOTALLY RE-Written.
  14.  
  15. PLEASE read this WHOLE note BEFORE You report problems.
  16.  
  17. You need NOT  go  on  any  further with "WhoCalled?" if you alter your PCBTEXT
  18. files. I search the "callers" file for  literals, that MATCH text EXACTLY in
  19. the PCBTEXT file. For example; if you change "(D)ownload Completed" to
  20. "(D)OWNLOAD COMPLETED", note  the  case  of  the letters, or alter
  21. PCBTEXT.fil, WHOCALLED may NOT work for you. Please keep in mind,
  22. those who use optional languages, those optional languages are simply
  23. modified PCBTEXT files.
  24.  
  25. The first item  I  guess everyone goes over with any utility that's written is
  26. the "I am not responsible" routine. Sorry guys/ladies, the same goes here. You
  27. KNOW what I mean. You are using WhoCalled? at your own risk.
  28.  
  29. I WILL say this, WhoCalled? is a VERY simple  utility that merely LOOKS at the
  30. callers file. It writes NOTHING to PCBoard's associated files.
  31.  
  32. Let's get on with the installation, I know you're in a hurry.
  33.  
  34. Log into the  "\WHOCALL"  subdirectory. HIGHLY recommended to use this utility
  35. in It's OWN directory. (on the HOME PCB machine for networks.)
  36.  
  37. Run whoSETUP and answer some brief questions. Please READ the help lines
  38. in the middle of the screen during each question. 
  39.  
  40. At The DOS Prompt, (AFTER either using whoSETUP or editing whoCFG.X
  41.                     yourself)
  42. type;
  43.  
  44. whoCALL whocfg.n/x 
  45.  
  46.   (where whocfg.n = which configuration file you want to use.)
  47.   (n=machine number)
  48.   (where x = the node number - ZERO for Clark's new TWO node BBS)
  49.   (This file does the work of sorting out all of the information)
  50.   (and puts it into the "temp" files. Explained below.)
  51.  
  52. whoNODE whocfg.n/x
  53.  
  54.    (where whocfg.n = which configuration you want to use.)
  55.    (n=machine number)
  56.    (where x = the node number - THIS FILE IS FOR THE WHOBULL.xxx)
  57.    (do NOT run this, if you ONLY want a bulletin of ALL your nodes)
  58.    (in ONE bulletin!)
  59.  
  60. whoALL  whocfg.n/x
  61.  
  62.         (this creates the bulletin WHOBULL.ALL for ALL nodes. - Do NOT)
  63.         (run this one, if you ONLY want a bulletin for EACH node.)
  64.  
  65.  
  66. You'll obviously want to include those lines in your $$LOGOFF.BAT.
  67.  
  68. For those of you who are new at this, if that file exists ($$LOGOFF.BAT)
  69. in your PCB's "home" directory, PCBoard V14.5a will run this batch file
  70. each time a user logs off.
  71.  
  72. Your $$LOGOFF.BAT should look like this:
  73.  
  74. cd [d:\] whocall
  75. whocall  whocfg.n/x
  76. whonode  whocfg.n/x
  77. whoall   whocfg.n/x
  78. cd [d:\] pcb
  79.  
  80. When those programs are through running, you'll have two files.
  81.  
  82. WHOBULL.XXX and WHOBULL.ALL, THOSE are the files you'll want to be
  83. displayed to your users. (The final output from WhoCalled.)
  84.  
  85. Version 5.03"N" command line is slightly confusing to glance at, but here's 
  86. a VERY brief explaination. The WHOCFG.n file, can be ANY configuration file
  87. so long as it meets the guidelines I explained in EXPLAIN.CFG. 
  88.  
  89. Doing things this way, makes the utility EXTREMELY flexible for 
  90. WHATEVER your setup consists of.
  91.  
  92. I wanted to accomodate network users. JUST AS PCBoard has a different 
  93. PCBOARD.DAT file for each node, WhoCalled TOO, needs to know 
  94. where certain files are. That information is contained in the file(s);
  95. WHOCFG.n. 
  96.  
  97. My Node I $$LOGOFF.BAT looks like this:
  98.  
  99. CD C:\WHOCALL
  100. whoCALL c:\whocall\whoocfg.1/1
  101. whoNODE c:\whocall\whocfg.1/1
  102. whoALL  c:\whocall\whocfg.1/1
  103. CD C:\PCB
  104.  
  105. If you have a single machine, but multi-nodes, you can STILL use the
  106. SAME configuration file. i.e. for my Node II, my $$LOGOFF.BAT looks
  107. like this:
  108.  
  109. CD C:\WHOCALL
  110. whoCALL c:\whocall\whocfg.1/2
  111. whoNODE c:\whocall\whocfg.1/2
  112. whoALL  c:\whocall\whocfg.1/2
  113. CD \PCB2
  114.  
  115.    (Network Users - For example, if you have THREE nodes on ONE REMOTE
  116.     MACHINE, you CAN use the SAME WHOCFG.x file, for a different node
  117.     on the SAME machine. Use the syntax WHOCALL WHOCFG.n/x, and simply 
  118.     use N as the machine number, and again, X as the NODE number.)
  119.  
  120. You'll need to include the SLASH! 
  121.  
  122. If you are running ONE node, there's NO need to run whoALL, likewise if you
  123. are running multiple nodes, and you ONLY want an ALL NODEs bulletin, then
  124. omit whoNODE.
  125.  
  126. Please note, PLEASE,  I  KNOW I'm going to get calls on this  one.  WhoCalled,
  127. when FIRST ran,  needs  to BUILD UP the temporary files up to the limit of the
  128. number of calls you specified in your configuration files for either the NODE
  129. bulletins or your ALL bulletins. What I'm trying to say is that the first time
  130. you run it, it will have ONE caller logged in there. The second  time  you run
  131. it, it will  have the second caller logged, and so forth, until it reaches the
  132. maximum number of callers you told WHOCALL.CFG to track.
  133.  
  134. When you run whoCALL.exe, if the LAST caller is the SAME as THIS caller,   it
  135. will NOT append your bulletin. (Makes sense, doesn't it?)
  136.  
  137. Your output bulletin(s) should look similar to this:
  138.  
  139. BBS Name Goes Here  - Node : 9
  140. Who Called? - V2.98 - Written By: Bill Fink
  141.  
  142.                              Time  Min. Connect #Msgs  Files  Files  Avg
  143. Date      User Name          On    Used Speed    Left   U/L    D/L   CPS
  144. ----------------------------------------------------------------------------
  145. 03-23-92  HORACIO CRISTINO   20:51  4   (2400)     0      0     0
  146. 03-23-92. ALEX BOWMAN        20:07  25  (19200E)   4      0     0
  147. 03-23-92  MARTIN HARDY       18:48  52  (2400)     0      0     2    230
  148. 03-23-92  MITCH KRZYZEK      18:43  1   (2400)     0      0     0
  149. 03-23-92■ BILL FINK          13:32  10  (2400)     1      0     0
  150. 03-23-92  MIKE GERARDI       12:55  8   (2400)     0      0     1    232
  151. 03-23-92  BILLS TESTING      00:06  0   (Local)    0      0     0
  152.  
  153. Previous xx Callers Tracked.
  154.  
  155. Note: The period next to Alex Bowman's  name  above indicated this user logged
  156. off "Abnormally."
  157.  
  158. Note: The ANSI character next to Bill Fink's name above. This indicates that
  159. the user *MAY* be the victim of a "Hack" attempt. (More than TWO attempts
  160. were made with different passwords.)
  161.  
  162. I am making a vow RIGHT HERE AND NOW, that I will NEVER post  anything  to the
  163. effect of "Your SysOp Is Cheap" in ANY "Who Called?" products!
  164.  
  165. * * * SINGLE NODE USERS! MAKE SURE YOU USE A ZERO "0"
  166.       as your node # when you invoke WhoCalled.
  167.  
  168.       This software WILL work with Clark's new 2 Node
  169.       version of the code as well.
  170.  
  171. The BBSes who  DID  test  the  product  did  NOT  have ANY problems with their
  172. "CALLER" or CFG    file(s). If YOU DO,   I  trust I  have written enough error
  173. trapping to catch any mistake that MAY have happened on your  part. If this is
  174. the case, the  utility  will  beep at you and the bulletin created will simply
  175. have the bulletin header (and nothing  else)  and  go  on about it's business.
  176. Your board will be back up when it's through.
  177.  
  178. You WILL run into problems if you've edited your CALLERs file. The contents of
  179. PCBoard's CALLERS file is written as a relative type file  and if you edit the
  180. file with an  ASCII  editor,  (OK  in  MOST  cases) you COULD have a distorted
  181. output file as your bulletin.
  182.  
  183.   * THIS IS OK * WHOCALLED? WILL trap it, but needs
  184.     to cycle through.
  185.  
  186. WhoCalled needs a temporary file for EACH node running. Forgive me on this one
  187. but to read a file (a RANDOM type file) from the bottom up, I needed to create
  188. those files to read from. Otherwise,  it  would  run  like  the OLD WhoCalled?
  189. V3.x, and take anywhere from 15 seconds to 20 seconds in between each call for
  190. say a 35 call limit.
  191.  
  192. There is GREAT news now! (New In Version 5) If you're inclined  to NOT like my
  193. header or footer files, you can simply ADD YOUR OWN. You MUST have something,
  194. even if there are blank lines. But, the choice is yours now to use mine OR
  195. yours.
  196.  
  197. WHOCALL.HDR and WHOCALL.FTR are the files that are appended to the bulletins
  198. before and after the raw data is placed, respectively.
  199.  
  200. WhoCalled? Uses  the  CALLER  file  for   it's  information. You can limit the
  201. number of callers that it checks and writes  to your bulletin using the
  202. WHOCFG.n file. See the WHOCFG.n FILE and read the EXPLAIN.CFG help file.
  203.  
  204. I can be reached at (401) 848-9176. PLEASE this is my HOME VOICE PHONE, try to
  205. keep it EARLIER than 6PM. (I'm taking  into  account  Pacific time) Let's face
  206. it, it's a lot easier if we can talk voice.
  207.  
  208. My BBS free access phone number is (401) 846-1763, which is v32bis, should you
  209. prefer to SEE the bulletins in action.  (And keep tabs on any upgrades.)
  210.  
  211. Use node II (401) 846-1763 to browse my bulletins files,  take  a  look at my
  212. bulletin #16, #17,  #18, and leave a comment, asking for help should you need
  213. any.
  214.  
  215. What EVER you do, PLEASE don't try WHOCALLED and if something went wrong, just
  216. delete all the files and forget about it.   Please call me, and let me know if
  217. the utility is not working for you for  your  configuration. I can NOT attempt
  218. to fix something, if I don't know it's broken.
  219.  
  220. I will NEVER  know  if you want something added, or something special for YOUR
  221. BBS if you don't call. Please CALL!
  222.  
  223. It's getting to the point that I've spent MANY hours with WhoCalled. If you
  224. REALLY want to see MORE upgrades, send a $10.00 "suggestion" to keep me at
  225. programming for WhoCalledPRO.
  226.  
  227. Bill FINK
  228. 4204 East Bay Village
  229. Middletown, RI 02840
  230.  
  231. Chris, thanks for your suggestions!
  232.  
  233. That's it, have FUN with WhoCalledPRO!
  234.  
  235. Bill FINK - SysOp / Owner / Manager - NCCBBS
  236. Middletown, Rhode Island
  237.  
  238.